home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / ACORNUSERS / EMULATOR / ADAMEM / !AdamEm / !Help < prev    next >
Text File  |  1998-08-26  |  7KB  |  193 lines
  1.  
  2.  
  3.                           ******* ADAMEm *******
  4.                      The Portable Coleco ADAM Emulator
  5.                                 Version 0.2
  6.                                 
  7.                     Copyright (C) 1996  Marcel de Kogel
  8.                                           
  9.                  Acorn Port by David McEwen 
  10.                  Port Version : 0.11 (26/8/98)
  11.                  
  12.                  NEW IN THIS VERSION
  13.                  -------------------
  14.                  
  15.                  - Assembler plotting routine
  16.                  
  17. Introduction
  18. ------------
  19.  
  20. This is a port of Marcel's very excellent ADAM emulator. This improves alot on ColEm
  21. as it is more comprehensive. The ADAM was a complete computer, not just a console
  22. like the Colecovision. This emulates both fairly comfortably. 
  23.  
  24. Key Mappings
  25. ============
  26. ADAM keyboard:
  27. F1-F6        -  Smart keys
  28. F7           -  WILD CARD
  29. F8           -  UNDO
  30. Insert       -  INSERT
  31. Delete       -  DELETE
  32. Home         -  MOVE/COPY
  33. End          -  STORE/GET
  34. Page Up      -  CLEAR
  35. Page Down    -  PRINT
  36. Keypad 5     -  HOME
  37. ColecoVision game controllers:
  38. Cursor keys             - Joystick movement
  39. Left Alt (Space in      - Primary firing button
  40. Unix/X version)
  41. Left Ctrl               - Secondary firing button
  42. Left Shift              - Third firing button (port 1)
  43. Z                       - Fourth firing button (port 1)
  44. NumPad -                - Third firing button (port 2)
  45. NumPad +                - Fourth firing button (port 2)
  46. 0-9, -, =               - Numpad 1
  47. 0-9, Del, Enter(right)  - Numpad 2
  48. Special Keys:
  49. F9                      - Toggle joystick/keyboard mode. In joystick
  50.                           mode, the keyboard is used to emulate the
  51.                           ColecoVision game controllers. In keyboard
  52.                           mode, it is used to emulate the ADAM keyboard
  53. Insert                  - Switch to joystick emulation mode 1 (Joystick
  54.                           mode only). For a description of the available
  55.                           joystick emulation modes, check the description
  56.                           of the -joystick command line option
  57. Home                    - Switch to joystick emulation mode 2 (Joystick
  58.                           mode only)
  59. Page Up                 - Switch to joystick emulation mode 3 (Joystick
  60.                           mode only)
  61. Delete                  - Swap joystick buttons (Joystick mode only)
  62. End                     - Swap keyboard buttons (Joystick mode only)
  63. Page Down               - Swap mouse buttons (Joystick mode only)
  64. Both Ctrls + Both Alts  - Main reset lever
  65. Both Ctrls + Both       - Cartridge reset lever
  66. Shifts
  67. F12                     - Quit emulator
  68.  
  69.  
  70. You can use the frontend to configure the state of the emulator. The options in the 
  71. window are basically aliases to command line options. The frontend is fairly basic,
  72. this is mainly because it sends a command line to run the program - this means that
  73. the number of options cannot be very large, due to command line constraints. In the
  74. near future the front end and emulator shall be integrated ala !ColEm - so you can
  75. have pause/resume by returning to the desktop. Also it will make it possible to 
  76. create a multitasking version. The last thing is unlikely to happen any time soon
  77. though - I know how to do it, but I just don't have time!!
  78.  
  79. The options you will find there are :
  80.  
  81. Resolution - Exactly the same as !ColEm
  82.  
  83. Ifreq - this should be 50 or 60, it is the refresh rate (ie either PAL or NTSC) 
  84.     Default 50
  85.  
  86. CPUSpeed - should be 100%, but lower values may help speed it up. Default 100
  87.  
  88. Sync Emu - This forces the emulator to synchronize on every VDP interrupt - ie lock at 50
  89.            or 60 fps. When not uses games disable this. The defult is on.
  90.           
  91. ColecoVision or ADAM - fairly obvious, default is ADAM
  92.  
  93. Disks/Tapes - select disks/tapes to use
  94.  
  95. Files of any type can be dragged to the disks/tapes boxes as I have not decided on a 
  96. filetype - yet!! 
  97.  
  98.  
  99. Current Limitations of Acorn Port
  100. ---------------------------------
  101.  
  102. 1. No mouse support - will be put in soon...
  103. 2. No sound - you can log sound from command line and then convert to midi using Col2Mid
  104.  
  105.  
  106. *FAQ*
  107. ----- 
  108.  
  109. Why are my Roms images not working ?
  110. -------------------
  111.  
  112. Try downloading them again. If there is still no joy. Send the image to 
  113. Marcel and see if he can find a reason. 
  114.  
  115. Where's the sound ?
  116. -------------------
  117.  
  118. This is being worked on... This will arrive at some point I am sorting out 
  119. how to do it nicely.
  120.  
  121. Do I need a special screen mode ?
  122. ---------------------------------
  123.  
  124. Nope the emulator runs happily in a 320 by 256 mode as the screen fits nicely. 
  125. The full screen modes require  specially defined modes... a Mode Definition File 
  126. is included. Currently it only runs in 256 colours, this will change soon, it is
  127. just a peculiarity of the emulation code.
  128.  
  129. Will you get it to run in the desktop ?
  130. ---------------------------------------
  131.  
  132. This will be coming shortly, hopefully with sound!
  133.  
  134. When will you add Mouse support ?
  135. ---------------------------------
  136.  
  137. Soon(-ish). I am in the final year of my degree and *really* shouldn't be wasting
  138. my time on porting emulators, but what the hell.
  139.  
  140.  
  141. Will you be porting any other emulators ?
  142. -----------------------------------------
  143.  
  144. Yes!!
  145.  
  146. OK... atm I have done 5 emulator ports :
  147.  
  148. ColEm
  149. fMsx
  150. xNes - very much under development, although it plays a nice Megaman 2!!
  151. Stella
  152. and this...
  153. but people are never happy :-(
  154.  
  155.  
  156. Copyright and Disclaimer
  157. ------------------------
  158.  
  159. This emulator is copyright Marcel de Kogel 1996, and the Acorn-specific
  160. components are copyright David McEwen 1998. You may not attempt to pass off
  161. any part of this work as your own, although you may distribute it freely as
  162. long as you supply the complete archive (that is, all the files supplied to
  163. you).
  164.  
  165. This software is supplied "as is". I make no claims about the reliability or
  166. suitability for any purpose of this emulator, and any use of it is undertaken
  167. at your own risk. No responsibility is taken for any failure of the software,
  168. or for any loss or damage caused directly or indirectly by the software.
  169.  
  170. Whilst I will endeavour to help you if you have problems with this emulator,
  171. no such support is guaranteed.
  172.  
  173. In the above "This emulator" refers to everything supplied within this
  174. archive, which is specifically the !AdamEm application and all the files
  175. contained within it, and also the documentation files (including the one you
  176. are reading now).
  177.  
  178.  
  179.  
  180. COMMENTS
  181. --------
  182.  
  183. Any comments about the emulator as such should go to Marcel de Kogel : 
  184. email : m.dekogel@student.utwente.nl
  185. Website : http://www.komkon.org/~dekogel/adamem.html
  186.  
  187. Any comments about the Acorn specific parts and please no inane emails giving 
  188. me ways of making money etc... just useful constructive stuff please
  189. email : dem95c@cs.nott.ac.uk
  190. Website : http://www.cs.nott.ac.uk/~dem95c
  191.  
  192.  
  193.